Match'em Poker Example
======================

Match'em Poker is a 'match 3' type game originally written for iOS. This 
project was created to study porting this game to a Qt platform using 
Qt GameEnabler.

Switch the cards on a grid to form different poker hands in any direction. 
Fill the score meter to advance to the next level. The score meter drops
continuously with time. If it reaches zero, the game is over.

The example has been tested to work with Qt 4.7.3 and Qt Mobility 1.1.3 on 
Symbian^3 and MeeGo 1.2 Harmattan.


PREREQUISITES
-------------------------------------------------------------------------------

- Qt basics
- OpenGL ES 2.0 intermediate


IMPORTANT FILES/CLASSES (Qt BUILD)
-------------------------------------------------------------------------------

Source files:

- main.cpp: Executes the application
- TileInterface.h: Interfaces for game and engine
- ParticleEngine: Simulates particles and draws them on the screen
- npclevel.h: The 'actual' game part of the application
- tilenpc.h: Implementation of an interface ITileGame. The platform-
  independent main game.
- GameWindow.h: The main window of Qt GameEnabler used to wrap the native OpenGL
                ES 2.0 code into the application
- GEAudioBuffer.h: Contains a single buffer of audio for playback
- GEAudioOut.h: Deploys QAudioOutput and uses it to play audio through a 
  platform-independent software mixer


REQUIRED CAPABILITIES
-------------------------------------------------------------------------------

None.


KNOWN ISSUES
-------------------------------------------------------------------------------

None.


BUILD & INSTALLATION INSTRUCTIONS (Qt BUILD)
-------------------------------------------------------------------------------

Preparations
~~~~~~~~~~~~

Check that you have the latest Qt/Qt SDK installed in the development 
environment and on the device.


Build & installation instructions using Qt SDK
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Open the Qt PRO file.
   File > Open File or Project, select pro-file

2. Select target(s), for example 'Qt for Symbian^3 (Qt SDK)', and press the 
   Finish button.

3. Press the Run button to build the project and create the Symbian install 
   package. The application is installed on the device.

NOTE: 
If you want to build the application on a desktop, you must provide libraries 
capable of OpenGL ES 2.0 (emulation). These are normally not preinstalled on 
desktop systems. You can get free emulation libraries from Imgtec:
http://www.imgtec.com/powervr/insider/sdkdownloads/index.asp#GLES2


COMPATIBILITY
-------------------------------------------------------------------------------

- Qt SDK 1.1
- Qt 4.7.3
- Qt Mobility 1.1.3
- iOS SDK 4.3

Tested on: 
- Nokia C7-00
- Nokia E7-00
- Nokia N8-00
- Nokia N950
- Apple iPhone 4

Developed with:
- Qt SDK 1.1
- Xcode 4.0


CHANGE HISTORY
-------------------------------------------------------------------------------

1.1 Added support for MeeGo 1.2 Harmattan
1.0 First version
